home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / COMM / TR3_20.ARJ / TR.DOC < prev    next >
Text File  |  1992-06-10  |  111KB  |  1,914 lines
  1. TeleReplica Instruction Manual
  2.  
  3. 0.    To Get TeleReplica Up and Running Quickly...
  4.  
  5.       If you will be using modems then read the modem setup suggestions at the
  6.       start of appendix A. Then read whichever of the following sections most
  7.       closely matches your own application:
  8.          A1  Consultant/Client via Modem
  9.              One consultant wishing to connect via modem to many different
  10.              clients in order to take over the clients' computers.
  11.          A2  Remote/Shared via Modem
  12.              One remote access PC to be taken over by many different users via
  13.              modem.
  14.          A3  Laptop/Desktop via Direct Cable
  15.              A simple direct connection with no modems.
  16.          A4  Remote/Shared via Common Mini-computer
  17.              Instead of a direct link between the two PCs, each PC will be
  18.              logged into a common UNIX system.
  19.          A5  Home/Office via Modem
  20.              A dedicated office PC to be taken over from a home PC.
  21.  
  22.  
  23. 1.    What TeleReplica Will Do
  24.  
  25. 1.1   TeleReplica will allow you to connect two IBM PC-compatible computers
  26.       together (via telephone lines and modems, or via a direct cable, or via a
  27.       common mini- or main-frame computer), and arrange for input to be
  28.       accepted from either keyboard, and for both displays to appear identical.
  29.       In this document the computer which is running normal programs is called
  30.       the host computer, and the other computer is called the replica computer,
  31.       since its display is a replica of the host computer's display.
  32.  
  33. 1.2   TeleReplica will do a reasonable job of optimizing the screen changes
  34.       transmitted, so that (for example) moving a highlighted menu bar will
  35.       appear almost immediately even at 1200 bps (provided the call is
  36.       relatively local).
  37.  
  38. 1.3   TeleReplica always updates the replica computer's screen to match the
  39.       current host screen. This means that if several commands are issued
  40.       without waiting for the display to catch up, then the replica screen will
  41.       be updated to show the final host screen, without wasting time
  42.       transmitting the intermediate screens.
  43.  
  44. 1.4   TeleReplica uses a password of up to 39 characters, which means an
  45.       intruder would (on average) take millions of years at 2400 bps to guess a
  46.       well chosen password! Since this password is transmitted automatically,
  47.       there is no need to keep it short and easy to remember - once TeleReplica
  48.       is installed, you will never need to enter the password manually.
  49.  
  50. 1.5   TeleReplica will allow the host site to call the replica site, or the
  51.       other way around. For consultants this means you can make your clients
  52.       pay the 'phone bills!
  53.  
  54. 1.6   TeleReplica will automatically detect the "baud" rate being used by the
  55.       replica computer, and set the host computer's "baud" rate to match. This
  56.       means that users with different speed modems can all access a single
  57.       host.
  58.  
  59. 1.7   TeleReplica uses less than 10K of memory on the host computer, which
  60.       means there should be enough memory left to run most applications.
  61.  
  62. 1.8   TeleReplica can be installed to "type" a command in response to the
  63.       'phone ringing, which allows better control than merely using the modem's
  64.       auto-answer capability. It can also send a command directly to the modem.
  65.  
  66. 1.9   TeleReplica will trap anything printed to any printer on the host PC, and
  67.       redirect it to the chosen printer at the replica PC. This redirection
  68.       takes place only when a session is active, so at other times the host can
  69.       be used to print normally even if TRHOST is still loaded.
  70.  
  71. 1.10  TeleReplica will allow the host PC to run with screen blanked and
  72.       keyboard dead for improved privacy.
  73.  
  74. 1.11  TeleReplica will support file transfers using external protocol programs
  75.       such as DSZ, which provide crash recovery and cope better with poor lines
  76.       than TeleReplica's built-in protocol.
  77.  
  78. 1.12  TR is "DESQview-Aware". See Appendix D for details.
  79.  
  80. 1.13  Full source code is available at a small cost. See REGISTER.DOC for
  81.       details.
  82.  
  83.  
  84. 2.    What TeleReplica Will NOT Do
  85.  
  86. 2.1   TeleReplica will not replicate graphics displays. If the user at the
  87.       replica computer runs a program that displays graphics, then the replica
  88.       display may show (textual) garbage. Keystrokes will still be transmitted
  89.       to the host computer, but the user must remember which keys are necessary
  90.       to get out of graphics mode again! TeleReplica gives a warning that
  91.       graphics mode has been entered, but by then it is too late to avoid it.
  92.       However, in an emergency TR can instruct the host computer to reboot, so
  93.       provided TRHOST is run from AUTOEXEC.BAT this provides a means of
  94.       recovery.
  95.  
  96. 2.2   TeleReplica will only replicate text page 0, and only as an 80 column by
  97.       25 line display.
  98.  
  99. 2.3   TeleReplica will only work with the standard keyboard buffer (starting at
  100.       the address in segment 0040h specified at offset 0080h, ending at the
  101.       address specified at offset 0082h, with head pointer stored at offset
  102.       001Ah, and tail pointer stored at offset 001Ch).
  103.  
  104. 2.4   Where TeleReplica is being used with a modem, it will work best if the
  105.       modem and modem cable provide carrier detect, data terminal ready and
  106.       ring indicator signals in addition to the minimum transmit data, receive
  107.       data and ground signals.
  108.  
  109. 2.5   TeleReplica will cause bad "snowing" on some older CGA display cards. No
  110.       attempt has been made to use the retrace intervals for screen memory
  111.       access.
  112.  
  113. 2.6   TeleReplica will slow down the normal operation of the host computer. On
  114.       a 4.77MHz PC performance can be halved; on a faster host the difference
  115.       will not be so noticeable.
  116.  
  117. 2.7   TeleReplica requires DOS 3.0 or later.
  118.  
  119. 2.8   TeleReplica will not work particularly well on a noisy 'phone line. File
  120.       transfers are error-checked, but normal screen updates are not. Normally
  121.       this will not be a problem, since a corrupted screen will be obvious to
  122.       the user and in any case TR will usually detect the problem and
  123.       automatically request a full refresh. However, if errors happen very
  124.       frequently then TR can spend all its time continually re-refreshing the
  125.       display! Printer capture also is not error-checked, so line noise will
  126.       garble the printout.
  127.  
  128.  
  129. 3.    Why Use TeleReplica?
  130.  
  131. 3.1   Access to Local Area Network from Home
  132.  
  133.       TeleReplica will allow you to connect into your office computer from
  134.       home. This means you do not need to take all your data files home with
  135.       you, and that you do not need to license additional copies of your
  136.       software (since your home computer is not running the software, only
  137.       replicating the screen of your office computer). If your office computer
  138.       is part of a local area network, then you automatically have access to
  139.       all the network facilities from home.
  140.  
  141.       We regularly use TeleReplica with such programs as WordPerfect,
  142.       WordPerfect Office (especially mail), WordStar, FoxBASE, Lotus-style
  143.       spreadsheets, all the Novell NetWare utilities, and our local area
  144.       network is regularly backed up after hours via TeleReplica! The only
  145.       programs we have come across that could not be used remotely either:
  146.          a) used graphics displays (e.g. WordPerfect preview); or
  147.          b) took over interrupts needed by TRHOST (e.g. comms programs); or
  148.          c) used text pages other than 0 (e.g. Turbo Debugger?)
  149.  
  150. 3.2   Software Support
  151.  
  152.       TeleReplica will allow you to take over your client's computer, so that
  153.       you can see what is going wrong. In many cases this will avoid the need
  154.       for an expensive trip to the client's site.
  155.  
  156.       For details of these and other applications, see the scenarios in
  157.       Appendix A.
  158.  
  159.  
  160. 4.    TeleReplica Host Installation
  161.  
  162.       To install TeleReplica at the host computer, first copy the files:
  163.       TRHOSTIN.EXE, TRHOSTC.EXE, TRHOST.EXE, TRPUT.EXE, TRGET.EXE, TRTALK.EXE,
  164.       TRCHECK.EXE, TRASK.EXE, TRDIAL.EXE, TREXTR.EXE, TREXTS.EXE, TRMODSET.EXE,
  165.       TRRZ.BAT and TRSZ.BAT into a directory (say \TR) on the host computer.
  166.       Then enter the command:
  167.          TRHOSTIN
  168.  
  169.       Your display should show a menu similar to:
  170.       ╔═══════════════════════════════════════════════════════════════════════╗
  171.       ║ TeleReplica Host 3.20 Installation Copyright (c) 1992 Douglas Thomson ║
  172.       ║                                                                       ║
  173.       ║    A. Select serial port (currently COM1)                             ║
  174.       ║    B. Change password (currently "password")                          ║
  175.       ║    C. Change modem initialization string (currently:                  ║
  176.       ║       "\rat &c1 &d2\r")                                               ║
  177.       ║    D. Change modem dialing format string (currently:                  ║
  178.       ║       "atdt %s\r")                                                    ║
  179.       ║    E. Select maximum "baud" rate (currently 2400)                     ║
  180.       ║    F. Use modem CARRIER DETECT signal (currently YES)                 ║
  181.       ║    G. Flow control (currently NONE)                                   ║
  182.       ║    H. Generate INT 9 on each key (currently NO)                       ║
  183.       ║    I. Respond to modem RING signal (currently NO)                     ║
  184.       ║    J. Reboot on loss of carrier (currently NO)                        ║
  185.       ║    K. Synchronize "baud" rate (currently YES)                         ║
  186.       ║    L. Send wakeup every 2 minutes (currently NO)                      ║
  187.       ║    M. Private mode (currently NO)                                     ║
  188.       ║    N. Printer redirection (currently HOST)                            ║
  189.       ║    O. Create consistent .TR file                                      ║
  190.       ║    Q. Abandon changes                                                 ║
  191.       ║    S. Save changes and leave installation program                     ║
  192.       ║                                                                       ║
  193.       ║ Selection:                                                            ║
  194.       ╚═══════════════════════════════════════════════════════════════════════╝
  195.       Consider each of these options in turn:
  196.  
  197. 4.1   Select Serial Port
  198.  
  199.       Another menu will appear:
  200.       ╔══════════════════════════════════════════════════════════╗
  201.       ║ TeleReplica Host Program Serial Port Selection           ║
  202.       ║                                                          ║
  203.       ║    0. Completed, no (further) change                     ║
  204.       ║ => 1. COM1 port (base 0x03F8, interrupt IRQ4)            ║
  205.       ║    2. COM2 port (base 0x02F8, interrupt IRQ3)            ║
  206.       ║    3. COM3 port (base 0x0000, interrupt IRQ4)            ║
  207.       ║    4. COM4 port (base 0x0000, interrupt IRQ3)            ║
  208.       ║    A. Custom base (currently 0x03F8)                     ║
  209.       ║    B. Custom interrupt (currently IRQ4)                  ║
  210.       ║                                                          ║
  211.       ║ Selection:                                               ║
  212.       ╚══════════════════════════════════════════════════════════╝
  213.       All four "standard" ports are listed, although the port addresses for
  214.       non-existent ports are unlikely to be meaningful (if you are lucky, they
  215.       will be flagged with a base of 0x0000). To select one of these ports,
  216.       just type the port number. If you have a non-standard port/interrupt
  217.       combination, then use A and B to specify exactly what you want. When you
  218.       are happy with the settings, select 0 to return to the main menu.
  219.  
  220.       Please note that I do not have access to any system which uses the AT IRQ
  221.       numbers (8-15), so I cannot guarantee the performance of TeleReplica when
  222.       these 16-bit cards are used. Also, since COM1 and COM3 share the same
  223.       interrupt, only one or other of these ports can be in use at the same
  224.       time (the same applies to COM2 and COM4).
  225.  
  226. 4.2   Change Password
  227.  
  228.       The string editing menu will appear:
  229.       ╔═══════════════════════════════════════════════════════════════════════╗
  230.       ║ TeleReplica Host Program Password Selection                           ║
  231.       ║                                                                       ║
  232.       ║ Edit existing string:                                                 ║
  233.       ║ password                                                              ║
  234.       ╚═══════════════════════════════════════════════════════════════════════╝
  235.       Whenever you see the "Edit existing string:" prompt, you can use the left
  236.       and right arrow keys to move the cursor through the string, and the
  237.       backspace and delete keys to delete characters to the left of or under
  238.       the cursor respectively. Any normal characters you type will be inserted
  239.       at the cursor position. If the first key you press is a normal printable
  240.       character then the string will be cleared automatically.
  241.  
  242.       You will not be able to enter more than the maximum allowed number of
  243.       characters for any string.
  244.  
  245.       Since you will only need to enter the password once during installation,
  246.       and never in normal use, it is recommended that you make the password
  247.       near the maximum length and quite random. The main thing is that no-one
  248.       should have any chance of guessing the password.
  249.  
  250. 4.3   Change Modem Initialization String
  251.  
  252.       The string editing menu will appear again, this time asking for the modem
  253.       initialization string. This string is transmitted to the modem at the
  254.       maximum "baud" rate when TRHOST runs for the first time. If you are using
  255.       an automatic power switch that powers up the host computer when the
  256.       'phone starts ringing, then the initialization string may need to answer
  257.       the 'phone (see scenario A2). There may also be various operating modes
  258.       that cannot be stored permanently in your modem's non-volatile memory,
  259.       and which must therefore be established each time TRHOST starts. In many
  260.       applications, where nothing needs to be changed, this string may be
  261.       empty.
  262.  
  263.       You will probably need to refer to the instruction manual for the host
  264.       modem to work out what if anything is required.
  265.  
  266.       As well as normal characters, you may need to include some special
  267.       characters such as carriage return. Carriage return can be encoded as \r
  268.       (see the main menu at the start of section 4). Alternatively, any
  269.       character can be entered in hexadecimal as \0x followed by two hex digits
  270.       (for example, the escape key is \0x1B).
  271.  
  272.       It may also be necessary to include some kind of delay. For example, some
  273.       modems go off into a world of their own for a second or so after a reset
  274.       command. Delays are entered in milliseconds as \D followed by the delay
  275.       (for example, \D1000. [1 second] or \D500. [half a second]). Delays are
  276.       only accurate to the nearest 1/18.2th of a second, so the number you
  277.       enter may be modified slightly to reflect the nearest possible actual
  278.       delay.
  279.  
  280. 4.4   Change Modem Dialing Format String
  281.  
  282.       This string determines what TRDIAL will send to the modem to dial a
  283.       number. The usual use of TRDIAL will be something like TRDIAL 221166, so
  284.       normally the dialing format string should contain a %s to insert the
  285.       number. For example, if the dialing string is "atdt %s\r" and the user
  286.       enters the previous dialing command, then what will be sent to the modem
  287.       is "atdt 221166\r".
  288.  
  289.       Alternatively, if only one number is required, then the dialing format
  290.       string may contain the actual number, in which case the user will only
  291.       need to enter TRDIAL by itself.
  292.  
  293.       Note that (when CARRIER DETECT is being used) TRDIAL will only send
  294.       anything to the modem if there is NO carrier detected - once a carrier
  295.       had been established the modem would not act on the command in any case,
  296.       but would send it through to the other end. When TRHOST is installed to
  297.       ignore CARRIER DETECT, TRDIAL will send data to the modem regardless.
  298.  
  299. 4.5   Select Maximum "Baud" Rate
  300.  
  301.       Another window will appear:
  302.       ╔═══════════════════════════════════════════════════════════════════════╗
  303.       ║ TeleReplica Host Program Maximum "Baud" Rate Selection                ║
  304.       ║                                                                       ║
  305.       ║ Enter "baud" rate:                                                    ║
  306.       ╚═══════════════════════════════════════════════════════════════════════╝
  307.       You should enter the maximum "baud" rate that the host modem is capable
  308.       of using. Usually this will be 1200, 2400 or 9600. Note that TRHOST can
  309.       automatically adjust to half this speed, a quarter of this speed, or one
  310.       eighth of this speed. Thus if you choose 9600 bps, TRHOST will be able to
  311.       work at 9600, 4800, 2400 or 1200 bps (provided the host modem can handle
  312.       these speeds).
  313.  
  314.       If you will be using a direct cable between two PCs, then 19200 should
  315.       work on all systems and 38400 will work on faster computers. If your
  316.       computers have NS16550AFN UART chips instead of the standard 8250 chips
  317.       then you may find speeds of 57600 or even 115200 work even on slower PCs
  318.       (not tested, I only have the 8250!).
  319.  
  320. 4.6   Use modem CARRIER DETECT signal
  321.  
  322.       Selecting this option will determine whether or not TRHOST will use the
  323.       carrier detect signal provided by the modem. If you are using a real
  324.       modem, then you should set this to YES and make sure the modem is
  325.       initialized so that it reports the true CD status from the 'phone line.
  326.  
  327.       If you are using a direct cable between two PCs, or connecting PCs via a
  328.       mini-computer, then set this option to NO.
  329.  
  330. 4.7   Flow control
  331.  
  332.       Selecting this option will bring up the following menu:
  333.       ╔══════════════════════════════════════════════════════════╗
  334.       ║ TeleReplica Host Program Flow Control Selection          ║
  335.       ║                                                          ║
  336.       ║    0. Completed, no (further) change                     ║
  337.       ║ => 1. No flow control                                    ║
  338.       ║    2. Hardware (RTS/CTS) flow control                    ║
  339.       ║    3. Software (XON/XOFF) flow control                   ║
  340.       ║    4. Both hardware and software flow control            ║
  341.       ║    5. Set inter-character gap time (currently 330 ms)    ║
  342.       ║                                                          ║
  343.       ║ Selection:                                               ║
  344.       ╚══════════════════════════════════════════════════════════╝
  345.  
  346. 4.7.1 TeleReplica can use the following flow control systems:
  347.       NONE     No flow control. Use this with a direct cable or with modems
  348.                that require no speed adjustment.
  349.       CTS      Hardware flow control using RTS (request to send) and CTS (clear
  350.                to send). Use this in preference to software flow control if it
  351.                is available.
  352.       XON      Software flow control using XON and XOFF (^S/^Q). Use this if
  353.                flow control is needed and hardware flow control is not
  354.                available.
  355.       BOTH     Use both software and hardware flow control. I can't imagine why
  356.                anyone would want this...
  357.  
  358. 4.7.2 Normally TeleReplica will not need to use any flow control even when it
  359.       is available. However, some modems communicate with the PC at a different
  360.       speed than that at which they communicate with other modems, so that it
  361.       is possible for the PC to "get ahead" of the modem and hence lose data.
  362.       In these cases it is necessary for the modem to tell the PC when to wait
  363.       a bit before sending the next byte.
  364.  
  365. 4.7.3 A side effect of software flow control is that TeleReplica will not use
  366.       ANY control characters: it will not send any, and it will ignore all
  367.       control characters received apart from XON and XOFF. This may be useful
  368.       for networks that respond to certain control characters; however, binary
  369.       file transfers will be slightly slower since 64 characters (control
  370.       characters with and without the parity bit) are not used. Note that both
  371.       TR and TRHOST must therefore either use or not use software flow control
  372.       - if one end uses software flow control and the other does not, then no
  373.       communication will be possible!
  374.  
  375. 4.7.4 When TRHOST is receiving characters (normally keys that have been pressed
  376.       at the remote PC - each key is encoded as two or three characters) it
  377.       waits a certain length of time after receiving the first character before
  378.       giving up and ignoring the key. This is important, since otherwise a
  379.       single byte introduced by noise on the line could cause all subsequent
  380.       keys to be misinterpreted (the second character of one key being treated
  381.       as the first character in the next key and so on). TR always sends all
  382.       the characters which constitute one key as close together as the
  383.       communication speed will allow, so usually a gap of even 0.1 seconds
  384.       means that something has gone wrong and that TRHOST should start looking
  385.       for a new key again. However, if the link between TR and TRHOST uses
  386.       packets, or for any other reason introduces significant gaps between two
  387.       characters that were sent together, then TRHOST may need to be adjusted
  388.       to tolerate longer gaps between characters which should be together.
  389.       Selecting option 5 will bring up the following screen:
  390.       ╔═══════════════════════════════════════════════════════════════════════╗
  391.       ║ TeleReplica Host Program Inter-character Gap Time Selection           ║
  392.       ║                                                                       ║
  393.       ║ Longest gap to be tolerated (ms): 330                                 ║
  394.       ╚═══════════════════════════════════════════════════════════════════════╝
  395.       Any time up to about 10 seconds (10000 ms) can be entered. Be aware that
  396.       if this time is set to 10 seconds, and line noise does introduce a stray
  397.       character, then you will need to wait 10 seconds without typing anything
  398.       at the remote PC to get TRHOST back into synchronization!
  399.  
  400. 4.8   Generate INT 9 on each key
  401.  
  402.       When TRHOST receives a key from TR, it will usually just place it in the
  403.       keyboard buffer to be found by any program that wants to read a key.
  404.       However, some applications monitor the keyboard interrupt (INT 9) and
  405.       only read the keyboard input buffer after there has been a keyboard
  406.       interrupt! To keep such programs happy, TRHOST can generate an INT 9
  407.       after it has placed a key into the buffer. However, this can cause
  408.       problems for other programs, particularly when the host and remote
  409.       keyboards may both be in use at the same time (e.g. TRTALK). Leave this
  410.       option OFF unless it is really necessary.
  411.  
  412. 4.9   Respond to modem RING signal
  413.  
  414.       Selecting this option will determine whether or not TRHOST will respond
  415.       to the RING signal which the modem provides to tell the PC that the
  416.       'phone is ringing. If this option is turned on, then the menu will be
  417.       extended with the following sub-options:
  418.  
  419.       G. Respond to modem RING signal (currently YES)───┬─ 1. too short  220 ms
  420.                                                         ├─ 2. too long  5000 ms
  421.                                                         ├─ 3. delay    10000 ms
  422.                                                         ├─ 4. reset    10000 ms
  423.                                                         ├─ 5. "type" response
  424.                                                         └─ 6. response ─┐
  425.                                                                 "\0x1Btrauto\r"
  426.  
  427. 4.9.1 If the 'phone only rings for a very short time, you may wish to ignore
  428.       the ringing completely - otherwise just knocking the 'phone off the hook
  429.       can trigger a TRHOST response!
  430.  
  431. 4.9.2 If the 'phone rings for a long time, then this may indicate that the
  432.       caller is a person who should not be greeted by an ear full of modem! If
  433.       TRHOST is intended to respond before the 'phone stops ringing, then this
  434.       time should be set the same as the delay below.
  435.  
  436. 4.9.3 After a certain length of time (measured from when the 'phone starts
  437.       ringing) TR will check that the amount of ringing was within the
  438.       specified range, and if so, will "type" the response string (see point
  439.       5).
  440.  
  441. 4.9.4 If the 'phone rang for too long, then TR must know when to start looking
  442.       for another call. If the 'phone has not rung for a certain length of time
  443.       then TR assumes any ringing must be a new call.
  444.  
  445. 4.9.5 The response string may be either "typed" (that is, inserted into the
  446.       keyboard buffer as if a user at the host PC had just typed it in), or it
  447.       can be sent direct to the modem. The advantage of "typing" is that you
  448.       can run a batch file to check times and do all sorts of other things. The
  449.       advantage of sending direct to the modem is that the entire operation can
  450.       take place in the background while an application continues running.
  451.  
  452. 4.9.6 You may specify a response of up to 39 characters. If you expect the host
  453.       PC to be at the DOS prompt when a call comes in, then it is a good idea
  454.       to start with an escape key, so that DOS discards anything already typed
  455.       and treats what follows as a new command.
  456.  
  457.       If all this sounds too complicated, but you still think you want to
  458.       enable ring response, then have a look at the configuration scenario
  459.       called "Home/Office via Modem" in section A5.
  460.  
  461. 4.10  Reboot on loss of carrier
  462.  
  463.       Selecting this option will determine whether or not the computer will
  464.       reboot when the modem reports that the carrier has been lost (presumably
  465.       because the other end hung up). See scenario A5 for an example of an
  466.       application taking advantage of this feature.
  467.  
  468.       The PC will not reboot unless there has been a TeleReplica session active
  469.       since TRHOST was loaded.
  470.  
  471. 4.11  Synchronize "baud" rate
  472.  
  473.       Selecting this option will determine whether or not TRHOST will attempt
  474.       to match the "baud" rate being used by TR at the other end. This is
  475.       useful if several users will all dial into the same host, but some users
  476.       have slower modems than others. See scenario A2 for an example of this.
  477.  
  478. 4.12  Send wakeup every 2 minutes
  479.  
  480.       Selecting this option will determine whether or not TRHOST will send a
  481.       NULL character whenever two minutes has passed with no other activity. A
  482.       single NULL is ignored by TR, but may serve to keep a connection to a
  483.       mini-computer link. See scenario A4 for an example of this.
  484.  
  485. 4.13  Private mode
  486.  
  487.       In private mode, the screen of the host PC will be blank, and the
  488.       keyboard of the host PC will be inactive (including CTRL-ALT-DEL). This
  489.       is useful to enhance privacy when the host PC is in a public location.
  490.       Note that the screen blanking has only been tested on VGA, EGA, CGA and
  491.       Hercules display cards, and only in text modes. It has worked correctly
  492.       with all the applications tested, but you should test it with your own
  493.       applications and display cards before relying on it!
  494.  
  495. 4.14  Printer redirection
  496.  
  497.       When a TeleReplica session is active, it is possible to redirect printer
  498.       output (which would otherwise be printed at the host PC) so that it is
  499.       printed at the replica PC instead. When no session is active, the host
  500.       will print normally even though TRHOST is still loaded.
  501.  
  502. 4.15  Create consistent .TR file
  503.  
  504.       Once TRHOST has been installed correctly, TRHOSTIN can create a
  505.       configuration file for TR that is consistent (same "baud" rate, password,
  506.       use of carrier detect etc). It will normally still be necessary to edit
  507.       this file to do some fine tuning, but the work required will be less than
  508.       if you started with the vanilla TR.TR file distributed with TR.
  509.  
  510. 4.16  Abandon Changes
  511.  
  512.       If you have made a mistake, or if you only wanted to see what the current
  513.       settings were, then this option allows you to quit without making any
  514.       changes.
  515.  
  516. 4.17  Save Changes and Leave Installation Program
  517.  
  518.       This is the normal way to exit this program when you have made all the
  519.       required changes. The relevant files (TRHOST.EXE, TRGET.EXE, TRPUT.EXE
  520.       TRTALK.EXE, TRDIAL.EXE, TREXTR.EXE, TREXTS.EXE and TRMODSET.EXE) will all
  521.       be modified appropriately.
  522.  
  523.       Note that the executable files are actually modified, so beware of virus
  524.       protection programs which compute checksums for executable files - they
  525.       are likely to report possible virus infections after installation! The
  526.       alternative (loading configuration information from a disk file) was
  527.       rejected due to the additional memory required for the file processing
  528.       code...
  529.  
  530.  
  531. 5.    Replica Installation
  532.  
  533.       To install TeleReplica at the replica computer, first copy the files:
  534.       TR.EXE, TR.HLP, and TR.TR (or better still the .TR file that was created
  535.       during host installation) into a directory (say \TR). Then use a text
  536.       editor to edit the .TR file. This file should look something like:
  537.  
  538.       ═════════════════════════════════════════════════════════════════════════
  539.           TeleReplica Configuration File
  540.           Do NOT change the order of these parameters, or delete any lines!
  541.  
  542.       "COM1"                Communications port ("COMn" or base/interrupt)
  543.       2400                  "Baud" rate (typically 300, 1200, 2400, or 9600)
  544.       "COMSPEC"             Pathname for DOS Command Interpreter (or "COMSPEC")
  545.       07                    Attribute for normal text (such as help screen)
  546.       47/70                 Attribute for file transfer monitoring
  547.       4F/0F                 Attribute for pop-up windows
  548.       "trput %s\r"          Host command to send (download) files
  549.       "trget\r"             Host command to receive (upload) files
  550.       0                     Printer (normally 0, 1 or 2)
  551.       440                   Frequency of "bell" tone (Hz)
  552.       100                   Duration of "bell" tone (ms)
  553.       256                   Block size for file upload (1-256)
  554.       8                     Number of block buffers for upload (1-8)
  555.       111                   Length of "break" (ms)
  556.       3000                  Time to wait for first char before timeout (ms)
  557.       500                   Time to wait for subsequent chars in block (ms)
  558.       56                    Time to wait between "typing" keys (ms)
  559.       "password"            Password to log in to host computer
  560.       "MODEM"               Type of link (MODEM, DIRECT, or OTHER)
  561.       "NONE"                Flow control (CTS, XON, BOTH or NONE)
  562.       "YES"                 Send BREAKs to host computer
  563.       "YES"                 Use BIOS for keyboard input
  564.       "[TR] %s"             DOS shell prompt format string
  565.       "LRCA"                Local command shifts (Left, Right, Ctrl, Alt)
  566.       ""                    Connect command for modem
  567.       ""                    Disconnect command for modem
  568.  
  569.           Each of the remaining lines must contain 3 strings and a number.
  570.           The first string is the trigger string to search for.
  571.           The second string is the response to be sent after the trigger.
  572.           The third string is the response to be sent after timeout.
  573.           The number is the time to wait before timeout (in ms).
  574.       ═════════════════════════════════════════════════════════════════════════
  575.  
  576.       Most of these parameters will not need to be changed.
  577.  
  578. 5.1   The serial port may be one of the standard ones ("COM1", "COM2", "COM3",
  579.       or "COM4") or you may specify the base address and interrupt number [e.g.
  580.       COM1 would be 03F8/IRQ4]. For compatibility with previous versions of TR,
  581.       you may also use a hex interrupt vector number, so that a third way to
  582.       specify COM1 is 03F8/0C.
  583.  
  584. 5.2   The "baud" rate should be set appropriately for the modem.
  585.  
  586. 5.3   The DOS command interpreter should normally be taken from the COMSPEC
  587.       environment variable. However, if this does not work (or does not select
  588.       the desired command interpreter) the full path name of a command
  589.       interpreter can be specified (e.g. "C:/DOS/COMMAND.COM" - or
  590.       "C:\\DOS\\COMMAND.COM" - the \\ is needed since \ introduces an escape
  591.       sequence).
  592.  
  593. 5.4   Video attributes are two hexadecimal digits: the first is the background
  594.       color, and the second is the foreground color. Optionally a second
  595.       attribute may be specified (e.g. 4F/70) - the first attribute is used for
  596.       color displays and the second is used for monochrome systems (this allows
  597.       a single control file to work without change with different displays).
  598.  
  599. 5.5   When the user running TR requests a file transfer, TR "types" the
  600.       necessary command at the host PC. These two lines should not be changed
  601.       except possibly to fill in a full path name if TRGET.EXE and TRPUT.EXE
  602.       are not in the path of the host PC.
  603.  
  604. 5.6   When host printing is being redirected to the replica computer's printer,
  605.       TR needs to know which printer to use. LPT1: is printer 0, LPT2: is
  606.       printer 1, and LPT3: is printer 2. Serial printers are not directly
  607.       supported.
  608.  
  609.       Note that it is not necessary or possible to specify which host printer
  610.       is to be redirected; anything sent to LPT1:, LPT2: or LPT3: will be
  611.       redirected. This was done to save the user the trouble of working out
  612.       which printer the host was using.
  613.  
  614. 5.7   The frequency (or pitch) and the duration of the "bell" can be modified
  615.       to suit your personal preferences (and the volume of your PC's speaker!).
  616.       The "bell" is used to indicate that some corruption of the data being
  617.       received by TR has occurred.
  618.  
  619. 5.8   The size of file transfer blocks and the number of buffers should not
  620.       need to be changed, except on a very poor 'phone line (in which case
  621.       smaller blocks and fewer buffers may improve matters). However, if the
  622.       line is this bad then TR will probably be unusable anyway...
  623.  
  624. 5.9   The length of "break" required is not likely to need to be changed -
  625.       unless perhaps a mini-computer requires longer?
  626.  
  627. 5.10  During a file transfer, TR will wait a certain time for the start of each
  628.       block. If nothing has been received within the time, then TR will request
  629.       the block be sent again (since presumably it got lost).
  630.  
  631. 5.11  Once the first character in a block has been received, the rest should
  632.       follow immediately - any gap probably means problems. However, when using
  633.       an overloaded mini-computer link (or using a packet network that may
  634.       introduce delays between packets, or using a modem with error correction,
  635.       compression or bps translation) this parameter could need to be longer.
  636.  
  637. 5.12  Since on many PCs (especially ones with CGA displays) interrupts are
  638.       disabled for LONG periods when writing to the screen, it is usually
  639.       necessary to make TR pretend to type quite slowly, especially when
  640.       sending things like file transfer commands. If you find you are losing
  641.       characters under these circumstances, then make this delay longer; if you
  642.       have a smart BIOS and/or version of DOS and/or command interpreter then
  643.       you may be able to get away with a shorter delay (even 0 ms). On all the
  644.       systems I have used, the time taken to send two characters at 2400 bps or
  645.       below is sufficient, so this delay is probably only needed above 2400
  646.       bps.
  647.  
  648. 5.13  The password must match the password installed in TRHOST at the host
  649.       computer.
  650.  
  651. 5.14  There are three kinds of link that may be used between two PCs:
  652.       MODEM    Use this if you are working with a modem that provides CARRIER
  653.                DETECT (note that you will require an appropriate cable [see
  654.                Appendix C1] and possibly some initialization of the modem [see
  655.                the start of Appendix A]).
  656.                You can also use this if you are using a null modem cable that
  657.                provides a CD line (see Appendix C3).
  658.       DIRECT   Use this if you are working with a three-wire null modem cable,
  659.                or if you are using a modem/cable that cannot provide accurate
  660.                CD information.
  661.       OTHER    Use this if you are working with a mini-computer link (see
  662.                scenario A4), or for initial modem setup (see the start of
  663.                Appendix A).
  664.  
  665. 5.15  TR can use the following flow control systems:
  666.       NONE     No flow control. Use this with a direct cable or with modems
  667.                that require no speed adjustment.
  668.       CTS      Hardware flow control using RTS (request to send) and CTS (clear
  669.                to send). Use this in preference to software flow control if it
  670.                is available.
  671.       XON      Software flow control using XON and XOFF (^S/^Q). Use this if
  672.                flow control is needed and hardware flow control is not
  673.                available.
  674.       BOTH     Use both software and hardware flow control.
  675.  
  676.       See the discussion of flow control under host installation for further
  677.       details.
  678.  
  679. 5.16  Normally TR should send BREAKs to TRHOST, but see scenario A4 for use
  680.       with a mini-computer link.
  681.  
  682. 5.17  Normally TR will use the BIOS for keyboard input. However, many BIOSes
  683.       filter out keys from enhanced keyboards (e.g. <F11>), and if use of these
  684.       keys is important then it may be necessary to NOT use the BIOS, but
  685.       rather to use the keyboard input buffer directly. Note however that some
  686.       keyboard enhancing programs (such as Newkey) will only work with the BIOS
  687.       setting. This is because they intercept the keyboard interrupt and store
  688.       keys away in some place other than the standard buffer area, so that TR
  689.       cannot find them!
  690.  
  691. 5.18  The DOS prompt for when you are in a TR shell can be edited to suit your
  692.       individual preferences - the %s inserts the original prompt.
  693.  
  694. 5.19  If you don't like the default <Ctrl-Alt-LeftShift-RightShift> key
  695.       combination to access local commands in TR, then you can change this to
  696.       any other combination of these four main shift keys ("CAL" would mean
  697.       <Ctrl-Alt-LeftShift> for example) - see scenario A3 for an application of
  698.       this).
  699.  
  700. 5.20  The connect command for the modem is sent when TR starts running (this
  701.       will often be a dial command). The modem command strings here have the
  702.       same format as those described above for the host computer installation
  703.       (with the addition of a \B escape sequence that causes TR to transmit a
  704.       BREAK). Make sure you leave the double quotes (") around each string!
  705.  
  706. 5.21  The disconnect command is sent when TR terminates (using exit option 3
  707.       only).
  708.  
  709. 5.22  The automatic response strings at the end of the file can be used to
  710.       respond to modem status messages. For example, if the replica computer's
  711.       modem is not set to auto-answer, then TR may need to respond to a "RING"
  712.       message from the modem by answering the 'phone - see scenario A5 for an
  713.       application. These strings can also be used to achieve an automatic login
  714.       to a mini-computer - see scenario A4 for an example. The trigger strings
  715.       are only active before a TR-TRHOST link is established. They are also
  716.       disabled once the final trigger string has been detected.
  717.  
  718.       Please note that since this file contains the password, anyone who
  719.       obtains a copy of this file can potentially access the host computer!
  720.  
  721.  
  722. 6.    How to Use TeleReplica
  723.  
  724.       The following instructions assume that TeleReplica has been correctly
  725.       installed (see sections 4 and 5). Only general guidelines are given here;
  726.       more details are provided in the scenarios in Appendix A.
  727.  
  728. 6.1   Host Computer
  729.  
  730.       First run the TRHOST program. If the replica computer is to originate the
  731.       'phone call, then this may be all that is necessary.
  732.  
  733.       If the host computer is to originate the call, then use the command:
  734.             TRDIAL
  735.       or
  736.             TRDIAL number
  737.       depending on how the dialing format string was installed.
  738.  
  739.       Once TRHOST is resident and the call is established, the host computer
  740.       can be used normally. The only difference is that everything that appears
  741.       on the screen is also being replicated on the replica computer's screen.
  742.  
  743.       The best way to remove TRHOST from memory is to run TRREMOVE. It is also
  744.       possible to use utilities such as marknet/relnet. Note that some common
  745.       mark/release utilities can NOT be used, because they do not restore the
  746.       interrupt mask register.
  747.  
  748. 6.2   Replica Computer
  749.  
  750.       Use the command:
  751.             TR                     [use TR.TR configuration file]
  752.       or
  753.             TR filename            [use filename.TR configuration file]
  754.  
  755.       If the replica computer was to originate the call, then the modem
  756.       initialization string in the configuration file will usually include a
  757.       dial command to call the host computer.
  758.  
  759.       If the host computer was to originate the call, then the initialization
  760.       string may contain an answer 'phone command. Note that in this case it is
  761.       important that the TR program not be run until after the 'phone starts
  762.       ringing! (Alternatively, there may be no initialization string, but
  763.       instead there may be a trigger string to respond to RING from the modem -
  764.       see scenario A5.)
  765.  
  766.       If the configuration file contains no modem initialization string, then
  767.       the user at the remote computer can enter modem commands manually. This
  768.       may be convenient for a consultant wishing to dial many different
  769.       clients. (Before a carrier is detected, TR will behave much like a normal
  770.       communications program.)
  771.  
  772.       Once both TR and TRHOST are running and connected to each other, they
  773.       will automatically adjust the host computer's "baud" rate (if this
  774.       feature is enabled) and the host computer will check the password
  775.       provided by the replica computer. Provided the password is correct, the
  776.       replica computer will effectively be able to take over the host computer,
  777.       or alternatively to observe whatever the host computer is doing. Any key
  778.       typed on the replica computer will be acted upon by the host computer,
  779.       and anything that appears on the host computer's screen will also appear
  780.       on the replica computer's screen.
  781.  
  782.       It is sometimes necessary to execute a command on the replica computer,
  783.       rather than transmitting the keystroke to the host computer. This is
  784.       achieved by holding down some combination of left shift, right shift,
  785.       ctrl and alt all at the same time (the exact combination is specified in
  786.       the .TR file currently in use). When you do this a list of all the
  787.       possible commands will be displayed, and you can then type the required
  788.       command key:
  789.  
  790.       F2      simulate a carrier signal (useful if the modem does not provide
  791.               this information) [link type should be OTHER to use this command]
  792.       Ctrl-F2 simulate NO carrier signal (opposite of F2)
  793.       F6      send break, restart session [use this if TeleReplica locks up -
  794.               very rare!]
  795.       F8      reboot the host computer (useful if host computer "hangs" for any
  796.               reason, but make sure TRHOST is run from AUTOEXEC.BAT!)
  797.       F9      shell directly to DOS, return to TR later by typing "exit"
  798.       F10     exit TeleReplica [optionally shell out and return later]
  799.       Home    refresh display from HOST [use this if a bad 'phone line messes
  800.               up the screen]
  801.       PgUp    upload file using DMP protocol [transfer file(s) from replica to
  802.               host]
  803.       PgDn    download file using DMP protocol [transfer file(s) from host to
  804.               replica]
  805.  
  806.       Note that before performing a file transfer, the host computer must be at
  807.       the DOS prompt, and TRGET.EXE and TRPUT.EXE must be accessible in the
  808.       current path (or alternatively the .TR file must contain full paths, not
  809.       just (say) TRGET but rather C:/TR/TRGET - note forward slashes!). If
  810.       TRGET/TRPUT cannot be found, then the host will display a "command not
  811.       found" error message, but TR will go on waiting for a response from
  812.       TRGET/TRPUT! Pressing any key will terminate this waiting and bring up an
  813.       appropriate error message.
  814.  
  815.       If a file transfer needs to access a file in another directory, it may be
  816.       convenient to shell out of TR, change directories, and then exit from DOS
  817.       back into TR to start the file transfer. TR will transmit any path that
  818.       you specify, so if the two PC's have equivalent directory structures it
  819.       is easy to transfer files to the corresponding directory on the other PC
  820.       (see Appendix B for a sample file transfer session).
  821.  
  822.  
  823. 7.    TeleReplica Utility Programs
  824.  
  825. 7.1   TRREMOVE
  826.  
  827.       This will search for a copy of TRHOST loaded in memory. If one is found,
  828.       then it is checked to see whether it is currently in use (if so, TRREMOVE
  829.       will ask for confirmation before removing it). If it is not in use, or if
  830.       it is to be removed anyway, all interrupts, the interrupt mask register
  831.       and the serial chip state are restored to their initial state when TRHOST
  832.       started running, and TRHOST's memory is freed.
  833.  
  834.       Please note that as with most TSR programs, this may not work unless
  835.       TRHOST was the most recent TSR to be loaded. In general TSR programs
  836.       should be unloaded in the reverse order they were loaded. In this case
  837.       "not working" means that any TSR loaded after TRHOST may cease to
  838.       function. If this is not possible then the use of marknet/relnet (or some
  839.       other mark/release utility that preserves the interrupt mask register as
  840.       well as the vectors) is recommended.
  841.  
  842.       It is sometimes convenient to be able to keep a modem connection even
  843.       though TRHOST is being unloaded. Normally, TRREMOVE will restore the
  844.       serial port state to its original state when TRHOST was first run.
  845.       However, it is possible to force the DTR line to be left active by
  846.       entering:
  847.             TRREMOVE ON
  848.       and DTR can be forced off by entering:
  849.             TRREMOVE OFF
  850.       If either ON or OFF is specified, then TRREMOVE assumes you know what you
  851.       are doing and does not ask for confirmation even if a link is active,
  852.       allowing TRREMOVE to be used in a batch file on the host PC without
  853.       pausing for input.
  854.  
  855.  
  856. 7.2   TRHOSTC
  857.  
  858.       This program works much like TRHOSTIN, except that instead of modifying
  859.       files on disk it modifies the copy of TRHOST currently active in memory.
  860.       Not all parameters may be altered "on the fly" - for example, the COM
  861.       port cannot be altered mid-session. The anticipated use for this program
  862.       is to do things like turning private mode on or off for just part of a
  863.       session...
  864.  
  865.       Note that the copy of TRHOST.EXE on disk is not modified.
  866.  
  867.  
  868. 7.3   TRTALK
  869.  
  870.       TRTALK will allow the users at the host and replica computers to "talk"
  871.       to each other. Anything that is typed at the host computer is displayed
  872.       in the top half of the screen, and anything that is typed at the replica
  873.       computer is displayed in the bottom half of the screen.
  874.  
  875.       TRTALK sends a special command to TR to tell TR that talk mode is
  876.       required, so that TR will send keys in a way that can be distinguished
  877.       from the host keys. If this command is lost, then what is typed at either
  878.       end will appear in the top window! If this happens, simply exit TRTALK
  879.       (Alt-X) and run it again.
  880.  
  881.       TRTALK also sends a special command to TR to tell TR to end talk mode. If
  882.       this command is lost, then TR will behave normally unless a program that
  883.       uses shift-key status is run, which will cause problems because in talk
  884.       mode TR does not send shift status information! To correct this problem,
  885.       use local TR command <F2> (simulate carrier), since a side effect of this
  886.       command is to end talk mode.
  887.  
  888.  
  889. 7.4   TREXTS and TREXTR
  890.  
  891.       These programs are normally called from TRSZ.BAT and TRRZ.BAT
  892.       respectively. They allow a clean interface between TeleReplica and
  893.       external file transfer programs such as DSZ.
  894.  
  895.       These programs are an exception to the rule that TRHOSTIN installs only
  896.       programs used at the host end; TREXTS.EXE and TREXTR.EXE both need to run
  897.       at both ends, so they must be installed for the correct modem port etc on
  898.       the replica as well as the host.
  899.  
  900.       Once TRHOSTIN has installed these programs correctly on both the host and
  901.       the replica, and TRRZ.BAT, TRSZ.BAT and the external protocol program
  902.       (such as DSZ.EXE) are in some directory on the path of both the host and
  903.       replica, file transfer is quite simple:
  904.  
  905. 7.4.1 To download a file from the host PC to the replica PC, simply enter the
  906.       following command on the host PC:
  907.             trsz <filename> ...
  908.       and TR will automatically run TRRZ on the replica without you doing
  909.       anything!
  910.  
  911. 7.4.2 To upload a file from the replica PC to the host PC, first ensure that
  912.       the host PC is at the DOS command prompt. Then shell out of TR (using
  913.       local F9). Finally enter the following command on the replica PC:
  914.             trsz <filename> ...
  915.       and TRHOST will automatically run TRRZ on the host.
  916.  
  917.       TRRZ.BAT, TRSZ.BAT, TREXTS.EXE and TREXTR.EXE all pass parameters on to
  918.       the external protocol program, so parameters other than file names can be
  919.       used if desired.
  920.  
  921.       TREXTS.EXE and TREXTR.EXE recognize one special parameter:
  922.             #portx#
  923.       which will substitute in the DSZ portx <base>,<IRQ> command. This allows
  924.       TRRZ.BAT and TRSZ.BAT to remain unchanged even when TeleReplica is
  925.       installed for a different port. See the supplied TRRZ.BAT and TRSZ.BAT
  926.       for examples of this.
  927.  
  928.  
  929. 7.5   TRMODSET
  930.  
  931.       Usage: TRMODSET [-fr] [filename]
  932.  
  933.       TRMODSET will send all the commands in TRMODSET.DAT (or in filename.DAT
  934.       if specified) to the modem, waiting for an "OK" response to each command.
  935.       This is useful to set up very complicated parameters necessary for some
  936.       of the more sophisticated modems. It assumes a modem that uses the Hayes
  937.       AT command set (at least at&f to restore factory defaults and OK in reply
  938.       to a good command).
  939.  
  940.       The -r command line option will cause TRMODSET to start with an "at&f"
  941.       command to reset the modem to factory defaults, just in case a previous
  942.       program has left the modem in a peculiar state. The "at&f" is sent before
  943.       TRMODSET starts monitoring for command echo or "OK" responses.
  944.  
  945.       If a carrier is present when TRMODSET runs then it will exit without
  946.       doing anything unless the "-f" (for "force") command line argument is
  947.       present. This allows TRMODSET to be run from AUTOEXEC.BAT without
  948.       disrupting an existing connection if the host PC needs to be rebooted.
  949.  
  950.       Note that TRMODSET is installed by TRHOSTIN, so if you want to use
  951.       TRMODSET on the replica PC you will need to install the host programs on
  952.       the replica PC (once installed, the other host programs may be deleted,
  953.       but they must be present for TRHOSTIN to run).
  954.  
  955.       Note also that you cannot use TRMODSET to set the modem to "no echo" or
  956.       "quiet" modes, since TRMODSET monitors that commands are being echoed and
  957.       that the modem is responding with "OK" to each command.
  958.  
  959.  
  960. 7.6   TRCHECK
  961.  
  962.       TRCHECK checks to see if the current time is within a specified range,
  963.       and returns the DOS errorlevel set to 0 if within the range and 1 if
  964.       outside the range. The following code might appear in an AUTOEXEC.BAT
  965.       file on a host computer:
  966.             trcheck 9:00:00 17:00:00
  967.             if not errorlevel 1 goto done
  968.             trhost
  969.             :done
  970.       The effect of this is to first check to see if the time is between 9AM
  971.       and 5PM. If so, then errorlevel is set to 0, and nothing further happens.
  972.       However, if the time is not between 9 and 5, then trhost will be run.
  973.  
  974.       This has proved valuable when TRHOST must run on an office computer
  975.       outside normal working hours, but the computer must be used normally
  976.       during the day. See also scenario A5 for a further application.
  977.  
  978.  
  979. 7.7   TRASK
  980.  
  981.       Usage: TRASK <timeout> <prompt> <answers>
  982.  
  983.       TRASK works much like a normal batch file enhancing ASK program, except
  984.       that it has a timeout. This is useful when a computer will usually be
  985.       used as a TeleReplica host, but sometimes must be used locally. Rather
  986.       than having to boot from a different disk, the following code might
  987.       appear in an AUTOEXEC.BAT file on a host computer:
  988.             @echo off
  989.             path c:\tr
  990.             trask 5 "Do you want to load TRHOST? (y/n)\a\a: " "yn"
  991.             if errorlevel 1 goto no
  992.             trhost
  993.             :no
  994.       The effect of this is to run TRHOST if the user presses the 'y' key or if
  995.       no key has been pressed after 5 seconds. If a user is at the computer and
  996.       answers 'n' then TRHOST will not be loaded. See scenario A5 for an
  997.       example of this.
  998.  
  999.       TRASK returns an errorlevel that depends on the <answers> string: the
  1000.       first letter in this string (or a timeout) returns error level 0, the
  1001.       second returns error level 1 and so on. Case is not significant unless
  1002.       the <answers> string contains the same letter in both upper and lower
  1003.       case.
  1004.  
  1005.       TRASK is a public domain program and may be distributed separately.
  1006.  
  1007.  
  1008.       APPENDIX A - Configuration Scenarios
  1009.  
  1010.       The following are specific situations in which TeleReplica has been used.
  1011.       The descriptions of the situations, and the resulting configurations of
  1012.       TeleReplica, are presented in detail. It is hoped that seeing the way
  1013.       TeleReplica was installed in some typical applications will help when it
  1014.       comes to installing TR for your own situation.
  1015.  
  1016.       Note that unless otherwise stated, all modems are assumed initially to be
  1017.       in the TeleReplica default state, to be connected to the PC via a 25-way
  1018.       straight-through modem cable, and to be Hayes-AT-command-compatible. To
  1019.       get a Hayes-AT-command-compatible modem into the TeleReplica default
  1020.       state the following commands should be sent to the modem using any normal
  1021.       communications program (or using TR SETUP or using TRMODSET):
  1022.             at &f         restore modem to "factory default"
  1023.             at &c1        modem should report true carrier status
  1024.             at &d2        modem should take notice of DTR to hang up 'phone
  1025.             at x4         (optional) give detailed status messages etc
  1026.             at &w         save current state for future use (the state is saved
  1027.                           in non-volatile RAM, so that this setup only needs to
  1028.                           be done once unless some other program interferes)
  1029.  
  1030.  
  1031. A1.   Consultant/Client via Modem
  1032.  
  1033. A1.1  Here the consultant is running a 2400 bps modem connected to COM1, and
  1034.       the client (whom we will call Fred) is running a similar modem also
  1035.       connected to COM1. Both computers are equipped with EGA color display
  1036.       cards. The consultant will be performing the TRHOST installation for the
  1037.       client, and then sending the client the installed version ready to run.
  1038.  
  1039.       When the client wants help, he will call the consultant (a normal voice
  1040.       call). When both parties are ready TeleReplica must take over the call.
  1041.  
  1042. A1.2  First the consultant must run TRHOSTIN, and make the changes necessary to
  1043.       achieve the following display:
  1044.       ╔═══════════════════════════════════════════════════════════════════════╗
  1045.       ║ TeleReplica Host 3.20 Installation Copyright (c) 1992 Douglas Thomson ║
  1046.       ║                                                                       ║
  1047.       ║    A. Select serial port (currently COM1)                             ║
  1048.       ║    B. Change password (currently "Fred's password")                   ║
  1049.       ║    C. Change modem initialization string (currently:                  ║
  1050.       ║       "")                                                             ║
  1051.       ║    D. Change modem dialing format string (currently:                  ║
  1052.       ║       "ata\r")                                                        ║
  1053.       ║    E. Select maximum "baud" rate (currently 2400)                     ║
  1054.       ║    F. Use modem CARRIER DETECT signal (currently YES)                 ║
  1055.       ║    G. Flow control (currently NONE)                                   ║
  1056.       ║    H. Generate INT 9 on each key (currently NO)                       ║
  1057.       ║    I. Respond to modem RING signal (currently NO)                     ║
  1058.       ║    J. Reboot on loss of carrier (currently NO)                        ║
  1059.       ║    K. Synchronize "baud" rate (currently YES)                         ║
  1060.       ║    L. Send wakeup every 2 minutes (currently NO)                      ║
  1061.       ║    M. Private mode (currently NO)                                     ║
  1062.       ║    N. Printer redirection (currently HOST)                            ║
  1063.       ║    O. Create consistent .TR file                                      ║
  1064.       ║    Q. Abandon changes                                                 ║
  1065.       ║    S. Save changes and leave installation program                     ║
  1066.       ║                                                                       ║
  1067.       ║ Selection:                                                            ║
  1068.       ╚═══════════════════════════════════════════════════════════════════════╝
  1069.       Refer to section 4 for the meaning of each option. Since both modems run
  1070.       at the same speed it does not matter whether "baud" rates get
  1071.       synchronized or not. Since Fred will only run TRHOST when he wishes to
  1072.       get help from the consultant, the password is not important. The modem
  1073.       dialing format string simply answers the 'phone - or more accurately,
  1074.       since the 'phone will already be in use for the voice call, it causes the
  1075.       modem to take over the call in "answer" mode.
  1076.  
  1077.       Next the consultant selects option O from the main menu, and enters the
  1078.       name of the configuration file he wishes to use for Fred:
  1079.       ╔═══════════════════════════════════════════════════════════════════════╗
  1080.       ║ TeleReplica Host Program .TR File Name Selection                      ║
  1081.       ║                                                                       ║
  1082.       ║ Edit existing string:                                                 ║
  1083.       ║ fred                                                                  ║
  1084.       ╚═══════════════════════════════════════════════════════════════════════╝
  1085.  
  1086.       Finally the consultant exits TRHOSTIN by selecting option S to save the
  1087.       changes. The consultant can now send Fred a disk with all the installed
  1088.       TeleReplica files on it (note that the consultant should also send Fred
  1089.       an unaltered original copy of the TeleReplica files in case Fred wants to
  1090.       pass them on to anyone - see the LICENCE.DOC file for details).
  1091.  
  1092. A1.3  Now the consultant needs to edit the file named FRED.TR to make a few
  1093.       alterations (TRHOSTIN only provides a starting point...). In particular,
  1094.       the following line must be changed:
  1095.             ""                Connect command for modem
  1096.       to:
  1097.             "at d\r"          Connect command for modem
  1098.       This command tells the modem to go "off hook" and take over the call in
  1099.       "originate" mode.
  1100.  
  1101.       This completes the installation stage.
  1102.  
  1103. A1.4  When Fred wants some help, he will run TRHOST and then 'phone the
  1104.       consultant and explain the problem. When the consultant is ready, he will
  1105.       enter the command:
  1106.             TR FRED
  1107.       and then instruct Fred to enter the command:
  1108.             TRDIAL
  1109.       and hang up the 'phone as soon as he (Fred) hears his modem making a
  1110.       "screaming" noise. After giving these instructions (and thus while Fred
  1111.       is still typing) the consultant will hang up his 'phone. Fred will finish
  1112.       entering the TRDIAL command, and hang up when he hears the screaming
  1113.       noise. TeleReplica will then take over the call, synchronize "baud"
  1114.       rates, exchange passwords, and give the consultant control of Fred's
  1115.       computer.
  1116.  
  1117. A1.5  When the consultant is finished, he will exit TR using option 3, which
  1118.       will cause the modem to hang up and terminate the 'phone call.
  1119.  
  1120.       Fred can either leave TRHOST running (it will do no harm, and uses less
  1121.       than 10K of memory), or else use TRREMOVE to uninstall TRHOST.
  1122.  
  1123.  
  1124. A2.   Remote/Shared via Modem
  1125.  
  1126. A2.1  Here a remote user wishes to connect into a local area network, and one
  1127.       node in the LAN is dedicated to this purpose. The main problem is that
  1128.       since the LAN node will be unattended, all it takes is one user to run a
  1129.       program which "hangs" the computer, and then no-one will be able to dial
  1130.       in until someone pushes the reset button on the node PC! However, in this
  1131.       scenario there is a modem-controlled switch box which turns on power to
  1132.       the node PC as soon as the 'phone starts ringing, and leaves the power on
  1133.       until either a minute or so has elapsed with no carrier being
  1134.       established, or until the carrier is lost (which will happen when the
  1135.       remote user hangs up). [These switch boxes are (I believe) commercially
  1136.       available, and indeed the electronics required is trivial to someone who
  1137.       feels at home with circuit diagrams and a soldering iron. We have several
  1138.       home-made ones in use here at MUCG.] This means there is no problem if a
  1139.       user "hangs" the computer; just hang up and then dial in again, and the
  1140.       computer will have been powered down and come up again clean!
  1141.  
  1142.       The node PC has a 2400 bps modem connected to COM2, and the remote user
  1143.       is running a 1200 bps modem connected to COM1. The node PC is equipped
  1144.       with a CGA color display card (with no monitor required). The remote PC
  1145.       is equipped with a Hercules monochrome display.
  1146.  
  1147.       The LAN manager will be performing the TRHOST installation for the node
  1148.       PC, and then providing all the remote users with a disk that is almost
  1149.       ready to go.
  1150.  
  1151.       The 'phone number of the node PC is 123 4567.
  1152.  
  1153. A2.2  First the LAN manager must run TRHOSTIN, and make the changes necessary
  1154.       to achieve something like the following display:
  1155.       ╔═══════════════════════════════════════════════════════════════════════╗
  1156.       ║ TeleReplica Host 3.20 Installation Copyright (c) 1992 Douglas Thomson ║
  1157.       ║                                                                       ║
  1158.       ║    A. Select serial port (currently COM2)                             ║
  1159.       ║    B. Change password (currently "sdggsdjgxvwept97867km,.mvikjdsdh")  ║
  1160.       ║    C. Change modem initialization string (currently:                  ║
  1161.       ║       "\rata\r")                                                      ║
  1162.       ║    D. Change modem dialing format string (currently:                  ║
  1163.       ║       "\r%s\r")                                                       ║
  1164.       ║    E. Select maximum "baud" rate (currently 2400)                     ║
  1165.       ║    F. Use modem CARRIER DETECT signal (currently YES)                 ║
  1166.       ║    G. Flow control (currently NONE)                                   ║
  1167.       ║    H. Generate INT 9 on each key (currently NO)                       ║
  1168.       ║    I. Respond to modem RING signal (currently NO)                     ║
  1169.       ║    J. Reboot on loss of carrier (currently NO)                        ║
  1170.       ║    K. Synchronize "baud" rate (currently YES)                         ║
  1171.       ║    L. Send wakeup every 2 minutes (currently NO)                      ║
  1172.       ║    M. Private mode (currently NO)                                     ║
  1173.       ║    N. Printer redirection (currently HOST)                            ║
  1174.       ║    O. Create consistent .TR file                                      ║
  1175.       ║    Q. Abandon changes                                                 ║
  1176.       ║    S. Save changes and leave installation program                     ║
  1177.       ║                                                                       ║
  1178.       ║ Selection:                                                            ║
  1179.       ╚═══════════════════════════════════════════════════════════════════════╝
  1180.       Refer to section 4 for the meaning of each option. Note that the modem
  1181.       initialization string answers the 'phone - this is nice in the case of
  1182.       timed call charges, since the remote user does not pay for the time it
  1183.       takes the PC to boot. Since some remote users will dial in at 2400 bps,
  1184.       TRHOST must be installed for 2400; but since other remote users will dial
  1185.       in at 1200 bps it is essential that "baud" rates get synchronized. Since
  1186.       anyone could try to get into the LAN via the node PC the password is very
  1187.       important - notice that it is both long and quite random.
  1188.  
  1189.       Next the LAN manager selects option O from the main menu, and enters the
  1190.       name of the configuration file he wishes to use for the node PC:
  1191.       ╔═══════════════════════════════════════════════════════════════════════╗
  1192.       ║ TeleReplica Host Program .TR File Name Selection                      ║
  1193.       ║                                                                       ║
  1194.       ║ Edit existing string:                                                 ║
  1195.       ║ lan1                                                                  ║
  1196.       ╚═══════════════════════════════════════════════════════════════════════╝
  1197.  
  1198.       Finally the LAN manager exits TRHOSTIN by selecting option S to save the
  1199.       changes. He can now make up a disk with all the installed TeleReplica
  1200.       files on it to give to the remote users, but first he must edit the
  1201.       LAN1.TR file to install the node PC's 'phone number. This means changing
  1202.       the line:
  1203.             ""                Connect command for modem
  1204.       to:
  1205.             "at d 123 4567\r" Connect command for modem
  1206.       so that when remote users run TR the number will be dialed automatically.
  1207.       Also, since modems more often use COM1 than COM2, the LAN manager should
  1208.       probably edit the line:
  1209.             "COM2"            Communications port (COMn or base/interrupt)
  1210.       to become:
  1211.             "COM1"            Communications port (COMn or base/interrupt)
  1212.  
  1213. A2.3  Now the remote user needs to edit his personal copy of the file named
  1214.       LAN1.TR to work at 1200 bps. The line containing:
  1215.             2400              "Baud" rate (typically 300, 1200, 2400, or 9600)
  1216.       must be changed to:
  1217.             1200              "Baud" rate (typically 300, 1200, 2400, or 9600)
  1218.  
  1219.       This completes the installation stage.
  1220.  
  1221. A2.4  When the remote user wishes to connect into the LAN, he will enter the
  1222.       command:
  1223.             TR LAN1
  1224.       This will cause the modem to dial the node PC, which will cause the modem
  1225.       switch box to turn on the power to the node PC, which will boot and then
  1226.       run TRHOST, which will make the node PC's modem answer the call.
  1227.       TeleReplica will then synchronize "baud" rates, exchange passwords, and
  1228.       give the remote user control of the node PC.
  1229.  
  1230. A2.5  When the remote user is finished, he will exit TR using option 3, which
  1231.       will cause the modem to hang up and terminate the 'phone call. The node
  1232.       PC will then be powered down until the next call.
  1233.  
  1234.  
  1235. A3.   Laptop/Desktop via Direct Cable
  1236.  
  1237. A3.1  Here someone wishes to connect a laptop computer to a desktop computer
  1238.       via a three-wire null modem cable. The reason for this is that the
  1239.       desktop only has a 5.25" disk, and the laptop only has a 3.5" disk, and
  1240.       it is necessary to transfer files between the two systems. The desktop
  1241.       computer is a 20MHz 80386, and the laptop is a 12MHz 80286. The cable is
  1242.       connected from COM1 on the desktop to COM1 on the laptop. The desktop has
  1243.       a VGA color display; the laptop has a gas plasma display that emulates
  1244.       EGA.
  1245.  
  1246.       It does not matter which PC is the host, but for the sake of this example
  1247.       we will assume the desk PC will be the host.
  1248.  
  1249.       The laptop computer has its <Del> key right next to <RightShift>, so the
  1250.       user does not wish to be using <Ctrl-Alt-LeftShift-RightShift> for fear
  1251.       of accidentally rebooting the computer. <Ctrl-Alt-LeftShift> seems a
  1252.       safer combination.
  1253.  
  1254. A3.2  First the user must run TRHOSTIN, and make the changes necessary to
  1255.       achieve something like the following display:
  1256.       ╔═══════════════════════════════════════════════════════════════════════╗
  1257.       ║ TeleReplica Host 3.20 Installation Copyright (c) 1992 Douglas Thomson ║
  1258.       ║                                                                       ║
  1259.       ║    A. Select serial port (currently COM1)                             ║
  1260.       ║    B. Change password (currently "password")                          ║
  1261.       ║    C. Change modem initialization string (currently:                  ║
  1262.       ║       "")                                                             ║
  1263.       ║    D. Change modem dialing format string (currently:                  ║
  1264.       ║       "")                                                             ║
  1265.       ║    E. Select maximum "baud" rate (currently 38400)                    ║
  1266.       ║    F. Use modem CARRIER DETECT signal (currently NO)                  ║
  1267.       ║    G. Flow control (currently NONE)                                   ║
  1268.       ║    H. Generate INT 9 on each key (currently NO)                       ║
  1269.       ║    I. Respond to modem RING signal (currently NO)                     ║
  1270.       ║    J. Reboot on loss of carrier (currently NO)                        ║
  1271.       ║    K. Synchronize "baud" rate (currently NO)                          ║
  1272.       ║    L. Send wakeup every 2 minutes (currently NO)                      ║
  1273.       ║    M. Private mode (currently NO)                                     ║
  1274.       ║    N. Printer redirection (currently HOST)                            ║
  1275.       ║    O. Create consistent .TR file                                      ║
  1276.       ║    Q. Abandon changes                                                 ║
  1277.       ║    S. Save changes and leave installation program                     ║
  1278.       ║                                                                       ║
  1279.       ║ Selection:                                                            ║
  1280.       ╚═══════════════════════════════════════════════════════════════════════╝
  1281.       Refer to section 4 for the meaning of each option. Notice that the "baud"
  1282.       rate is set to 38400 for fast file transfers (this works well on my test
  1283.       system, but slower speeds may be needed on other systems - experiment!).
  1284.       Obviously here the password is not important. Since the three-wire cable
  1285.       will not provide any carrier information, it is essential that carrier be
  1286.       ignored.
  1287.  
  1288.       Next the user selects option O from the main menu, and enters the name of
  1289.       the configuration file he wishes to use for the desktop:
  1290.       ╔═══════════════════════════════════════════════════════════════════════╗
  1291.       ║ TeleReplica Host Program .TR File Name Selection                      ║
  1292.       ║                                                                       ║
  1293.       ║ Edit existing string:                                                 ║
  1294.       ║ desk                                                                  ║
  1295.       ╚═══════════════════════════════════════════════════════════════════════╝
  1296.  
  1297.       Finally the user exits TRHOSTIN by selecting option S to save the
  1298.       changes.
  1299.  
  1300. A3.3  Next the user needs to edit the file named DESK.TR to use the shift key
  1301.       combination required for the laptop. The line containing:
  1302.             "LRCA"            Local command shifts (Left, Right, Ctrl, Alt)
  1303.       must be changed to:
  1304.             "LCA"             Local command shifts (Left, not Right, Ctrl, Alt)
  1305.  
  1306.       The user can now copy the installed files onto a 5.25" floppy disk, take
  1307.       the disk to a computer that has both 5.25" and 3.5" inch drives, and copy
  1308.       the file onto a 3.5" disk for the laptop.
  1309.  
  1310.       This completes the installation stage.
  1311.  
  1312. A3.4  When the user wishes to connect the two computers, he will enter the
  1313.       command:
  1314.             TRHOST
  1315.       on the desktop, and the command:
  1316.             TR DESK
  1317.       on the laptop. This will cause TeleReplica to synchronize "baud" rates,
  1318.       exchange passwords, and give the user control of the desktop computer
  1319.       from the laptop. Files can now be transferred at almost 3.8K per second!
  1320.  
  1321. A3.5  When the user is finished, he will exit TR using option 3, which will
  1322.       take the laptop back to normal, but leave TRHOST in the desktop's memory
  1323.       (see A1.5 for further discussion of this).
  1324.  
  1325.  
  1326. A4.   Remote/Shared via Common Mini-computer
  1327.  
  1328. A4.1  Here a remote user wishes to connect into a local area network, and one
  1329.       node in the LAN is dedicated to this purpose. There is no direct link
  1330.       between the PCs; instead, both the node PC and the remote user must log
  1331.       into the same mini-computer and run a link program (such as trfifo) to
  1332.       establish a connection via the mini-computer.
  1333.  
  1334.       One problem is that since the LAN node will be unattended, all it takes
  1335.       is one user to run a program which "hangs" the computer, and then no more
  1336.       remote users will be able to connect to the LAN until someone pushes the
  1337.       reset button on the node PC! (Note that TeleReplica does support
  1338.       rebooting the host PC, but this can only work if interrupts are not
  1339.       disabled and if the relevant code has not been overwritten. As a rule,
  1340.       TeleReplica can get out of any situation that <Ctrl-Alt-Del> could get
  1341.       out of, but if the hardware reset button was needed TR would be
  1342.       helpless.)
  1343.  
  1344.       Another potential problem is that if one user exits TR while still logged
  1345.       in to the LAN, then the next user could pick up the session! This is
  1346.       avoided by having the link program send a "reboot" command to the node PC
  1347.       when the link is broken.
  1348.  
  1349.       Trfifo cannot pass BREAKs from one end to the other; instead, BREAK is
  1350.       used to terminate the execution of trfifo. This means that TR must not
  1351.       send a BREAK unless it wants to kill the link.
  1352.  
  1353.       To make life complicated, the mini-computer will automatically disconnect
  1354.       any terminal that does no input or output for 5 minutes. However, the
  1355.       node PC must remain connected to the mini-computer all day waiting for
  1356.       remote users to connect in.
  1357.  
  1358.       The mini-computer links are set at 9600 bps, and cannot be changed. Both
  1359.       computers are connected to the mini-computer via COM1, and both computers
  1360.       are running color displays (however, the dedicated node PC requires no
  1361.       monitor).
  1362.  
  1363.       The LAN manager will be performing the TRHOST installation for the node
  1364.       PC, and then providing all the remote users with a disk that is almost
  1365.       ready to go.
  1366.  
  1367. A4.2  First the LAN manager must run TRHOSTIN, and make the changes necessary
  1368.       to achieve something like the following display:
  1369.       ╔═══════════════════════════════════════════════════════════════════════╗
  1370.       ║ TeleReplica Host 3.20 Installation Copyright (c) 1992 Douglas Thomson ║
  1371.       ║                                                                       ║
  1372.       ║    A. Select serial port (currently COM1)                             ║
  1373.       ║    B. Change password (currently "sdfddffgjkiou774htgjhgsduh875sdh")  ║
  1374.       ║    C. Change modem initialization string (currently:                  ║
  1375.       ║       "")                                                             ║
  1376.       ║    D. Change modem dialing format string (currently:                  ║
  1377.       ║       "")                                                             ║
  1378.       ║    E. Select maximum "baud" rate (currently 9600)                     ║
  1379.       ║    F. Use modem CARRIER DETECT signal (currently NO)                  ║
  1380.       ║    G. Flow control (currently NONE)                                   ║
  1381.       ║    H. Generate INT 9 on each key (currently NO)                       ║
  1382.       ║    I. Respond to modem RING signal (currently NO)                     ║
  1383.       ║    J. Reboot on loss of carrier (currently NO)                        ║
  1384.       ║    K. Synchronize "baud" rate (currently NO)                          ║
  1385.       ║    L. Send wakeup every 2 minutes (currently YES)                     ║
  1386.       ║    M. Private mode (currently NO)                                     ║
  1387.       ║    N. Printer redirection (currently HOST)                            ║
  1388.       ║    O. Create consistent .TR file                                      ║
  1389.       ║    Q. Abandon changes                                                 ║
  1390.       ║    S. Save changes and leave installation program                     ║
  1391.       ║                                                                       ║
  1392.       ║ Selection:                                                            ║
  1393.       ╚═══════════════════════════════════════════════════════════════════════╝
  1394.       Refer to section 4 for the meaning of each option. The password is not so
  1395.       critical here, since a user must be able to log into the mini-computer
  1396.       before getting through to the node PC. The mini-computer line will not
  1397.       provide any carrier information, so this must be ignored. "Baud" rates
  1398.       must NOT be synchronized, since a NULL character transmitted at 2400 bps
  1399.       would be received as a BREAK by the mini-computer at 9600 bps! To avoid
  1400.       the node PC getting logged out, TRHOST must send a NULL character to
  1401.       "wake up" the mini-computer every few minutes. This will be ignored by
  1402.       TR.
  1403.  
  1404.       Next the LAN manager selects option O from the main menu, and enters the
  1405.       name of the configuration file he wishes to use for the node PC:
  1406.       ╔═══════════════════════════════════════════════════════════════════════╗
  1407.       ║ TeleReplica Host Program .TR File Name Selection                      ║
  1408.       ║                                                                       ║
  1409.       ║ Edit existing string:                                                 ║
  1410.       ║ lan2                                                                  ║
  1411.       ╚═══════════════════════════════════════════════════════════════════════╝
  1412.  
  1413.       Finally the LAN manager exits TRHOSTIN by selecting option S to save the
  1414.       changes. He can now make up a disk with all the installed TeleReplica
  1415.       files on it to give to the remote users.
  1416.  
  1417. A4.3  Due to the way trfifo buffers input (or possibly some other peculiarity
  1418.       of our mini-computer?) the delay between sending keys needs to be 165 ms
  1419.       to avoid losing characters! Therefore, the line containing:
  1420.             56                Time to wait between "typing" keys (ms)
  1421.       must be changed to:
  1422.             165               Time to wait between "typing" keys (ms)
  1423.  
  1424.       Also, since we are using a mini-computer link, the line containing:
  1425.             "DIRECT"           Type of link (MODEM, DIRECT, or OTHER)
  1426.       must be changed to:
  1427.             "OTHER"            Type of link (MODEM, DIRECT, or OTHER)
  1428.  
  1429.       Finally, TR is capable of automating the mini-computer login process. If
  1430.       this is desired, then something like the following lines must be added at
  1431.       the end of the file:
  1432.             "DISCONNECTED"      "\D250\r"               "\r"             5000
  1433.             "Enter RESOURCE ? " "\D100G9000\r"          "\r"             5000
  1434.             "CONNECTED TO"      ""                      ""               5000
  1435.             "login: "           "\D100doug\r"           "\B\r"            500
  1436.             "Password:"         "\D100password\r"       "\r"            10000
  1437.             "Selection: "       "\D100d\r"              ""              40000
  1438.             "/users/doug>"      "\D100trfifo lan2\r"    ""              40000
  1439.             "and run TR"        "\D1000"                ""              40000
  1440.       The exact strings will depend on the mini-computer. This example (apart
  1441.       from the password) works for the author.
  1442.  
  1443.       This completes the installation stage.
  1444.  
  1445. A4.4  When the remote user wishes to connect into the LAN, he will run TR:
  1446.             TR LAN2
  1447.       which will automatically log into the mini-computer and run trfifo to
  1448.       connect to the node PC (in this case lan2).
  1449.  
  1450.       TeleReplica will then synchronize "baud" rates, exchange passwords, and
  1451.       give the remote user control of the node PC.
  1452.  
  1453. A4.5  When the remote user is finished, he will exit TR using option 3, which
  1454.       will send a BREAK to the mini-computer. This will terminate the trfifo
  1455.       program which the remote user was running. The trfifo program that the
  1456.       node PC was running will detect that this has happened, and send a
  1457.       TeleReplica reboot command to the node PC to ensure that the next user
  1458.       cannot pick up anything the previous user left running. The node PC's
  1459.       trfifo program will then prepare for the next remote user. The node PC
  1460.       will complete rebooting, and run TRHOST from AUTOEXEC.BAT ready for the
  1461.       next remote login.
  1462.  
  1463.       [All this sounds complicated, but we use this system daily here at MUCG
  1464.       for some staff who have mini-computer lines but are too far away for LAN
  1465.       connections.]
  1466.  
  1467.  
  1468. A5.   Home/Office via Modem
  1469.  
  1470. A5.1  Here a user wishes to dial in from home and take over the PC on his desk
  1471.       at work. The office PC has a 2400 bps modem connected to COM2, and the
  1472.       home PC has a 2400 bps modem connected to COM1. The office PC is equipped
  1473.       with an EGA color display, and the home PC is equipped with a Hercules
  1474.       monochrome display.
  1475.  
  1476.       One problem is that since the office PC will be unattended, all it takes
  1477.       is for the user to run a program which "hangs" the computer, and that
  1478.       will be the end of the office PC until the user goes back to work and
  1479.       presses the reset button! (Note that TeleReplica does support rebooting
  1480.       the host PC, but this can only work if interrupts are not disabled and if
  1481.       the relevant code has not been overwritten. As a rule, TeleReplica can
  1482.       get out of any situation that <Ctrl-Alt-Del> could get out of, but if the
  1483.       hardware reset button was needed TR would be helpless.)
  1484.  
  1485.       Since the user is putting in overtime working at night without getting
  1486.       paid for it, it seems reasonable that the office 'phone should at least
  1487.       pay for the call. However, how can the office computer know when to call
  1488.       the user at home? One possibility would be to set up a batch file to run
  1489.       TRDIAL at a predetermined time. However, it would be better if the user
  1490.       could choose any convenient time. TeleReplica can achieve this by
  1491.       monitoring the RING signal from the modem, and responding appropriately.
  1492.       The basic idea is that the user will dial the office number, and then
  1493.       hang up as soon as the 'phone starts ringing. TeleReplica will detect the
  1494.       'phone ringing, and respond by calling the user at home.
  1495.  
  1496.       Since the user does not want to be bothered by nuisance calls from the
  1497.       office computer, TeleReplica needs to be quite selective about the ring
  1498.       patterns it will respond to. Too short a ring may mean a telephone
  1499.       company routine line test. Too long a ring will mean a person trying to
  1500.       ring the office. Even if the ring is the correct length, the user may
  1501.       still wish to guarantee no interruptions between 11PM and 7AM!
  1502.  
  1503.       The 'phone number of the office PC is 123 4567.
  1504.       The 'phone number of the home PC is 765 4321.
  1505.  
  1506. A5.2  First the user must run TRHOSTIN, and make the changes necessary to
  1507.       achieve something like the following display:
  1508.       │═══════════════════════════════════════════════════════════════════════╗
  1509.       │plica Host 3.20 Installation Copyright (c) 1992 Douglas Thomson        ║
  1510.       │                                                                       ║
  1511.       │Select serial port (currently COM2)                                    ║
  1512.       │Change password (currently "fhkjeuyibn4593874sefeh8631wjds874dffd")    ║
  1513.       │Change modem initialization string (currently:                         ║
  1514.       │"")                                                                    ║
  1515.       │Change modem dialing format string (currently:                         ║
  1516.       │"\r%s\r")                                                              ║
  1517.       │Select maximum "baud" rate (currently 2400)                            ║
  1518.       │Use modem CARRIER DETECT signal (currently YES)                        ║
  1519.       │Flow control (currently NONE)                                          ║
  1520.       │Generate INT 9 on each key (currently NO)                              ║
  1521.       │Respond to modem RING signal (currently YES)───┬─ 1. too short  220 ms ║
  1522.       │Reboot on loss of carrier (currently YES)      ├─ 2. too long  5000 ms ║
  1523.       │Synchronize "baud" rate (currently YES)        ├─ 3. delay    10000 ms ║
  1524.       │Send wakeup every 2 minutes (currently NO)     ├─ 4. reset    10000 ms ║
  1525.       │Private mode (currently NO)                    ├─ 5. "type" response   ║
  1526.       │Printer redirection (currently HOST)           └─ 6. response ─┐       ║
  1527.       │Create consistent .TR file                             "\0x1Btrauto\r" ║
  1528.       │Abandon changes                                                        ║
  1529.       │Save changes and leave installation program                            ║
  1530.       │                                                                       ║
  1531.       │ion:                                                                   ║
  1532.       │═══════════════════════════════════════════════════════════════════════╝
  1533.       Refer to section 4 for the meaning of each option. Since anyone could try
  1534.       to get into the office PC the password is important - notice that it is
  1535.       both long and quite random. The modem dialing format string permits ANY
  1536.       modem command to be sent direct to the modem. It is essential that TRHOST
  1537.       takes notice of the CD signal, since the host computer will be
  1538.       automatically rebooted if the carrier is lost (see below). The host
  1539.       computer is to monitor the 'phone ringing and respond accordingly (again,
  1540.       see below). "Baud" rate synchronization is not important here.
  1541.  
  1542.       Next the user selects option O from the main menu, and enters the name of
  1543.       the configuration file he wishes to use for the office:
  1544.       ╔═══════════════════════════════════════════════════════════════════════╗
  1545.       ║ TeleReplica Host Program .TR File Name Selection                      ║
  1546.       ║                                                                       ║
  1547.       ║ Edit existing string:                                                 ║
  1548.       ║ office                                                                ║
  1549.       ╚═══════════════════════════════════════════════════════════════════════╝
  1550.  
  1551.       Finally the user exits TRHOSTIN by selecting option S to save the
  1552.       changes. He can now make up a disk with all the installed TeleReplica
  1553.       files on it to take home.
  1554.  
  1555.       However, still on the office PC the user needs to create a batch file
  1556.       called TRAUTO.BAT, containing something like:
  1557.             trcheck 7:00:00 23:00:00
  1558.             if errorlevel 1 goto done
  1559.             trdial atd7654321
  1560.             :done
  1561.       which will check that the time is between 7AM and 11PM, and if so dial
  1562.       the user's home number. Note that the "atd7654321" contains no spaces!
  1563.  
  1564.       The user must also ensure that AUTOEXEC.BAT has the directory containing
  1565.       all the TeleReplica files on the path, and that TRHOST is run whenever
  1566.       the system boots. However, when the user is at the office he will not
  1567.       want TRHOST loaded, so AUTOEXEC.BAT should contain something like:
  1568.             @echo off
  1569.             prompt $p$g
  1570.             path c:\tr
  1571.             trask 5 "Do you want to load TRHOST? (y/n): " "yn"
  1572.             if errorlevel 1 goto no
  1573.             trhost
  1574.             :no
  1575.       This will ask the user at the host PC whether or not to load TRHOST, and
  1576.       if the user does not say no within 5 seconds TRHOST will be loaded
  1577.       anyway. If the user is at the office, then typing 'n' will prevent TRHOST
  1578.       from loading.
  1579.  
  1580. A5.3  At home the user needs to edit the file named OFFICE.TR to install the
  1581.       office PC's 'phone number. This means changing the line:
  1582.             ""                Connect command for modem
  1583.       to:
  1584.             "at d 123 4567\r" Connect command for modem
  1585.       so that when the user runs TR the number will be dialed automatically.
  1586.  
  1587.       Next, since the home modem is on COM1 the line:
  1588.             "COM2"            Communications port (COMn or base/interrupt)
  1589.       must become:
  1590.             "COM1"            Communications port (COMn or base/interrupt)
  1591.  
  1592.       Finally, TR should respond to the modem ringing by answering the 'phone.
  1593.       This means adding an extra line at the end of the file containing:
  1594.             "RING"       "\D250ata\r"       ""       40000
  1595.       (Note the \D250 to wait a little bit for the modem to finish sending the
  1596.       carriage return and line feed after RING before sending the answer
  1597.       command. With some modems this may not be necessary; with others, a
  1598.       different delay may work better. If the answer command is ignored, then
  1599.       try a different delay.)
  1600.  
  1601.       This completes the installation stage.
  1602.  
  1603. A5.4  Before leaving the office, the user must remember to reboot the PC (thus
  1604.       loading TRHOST) and leave it turned on! However, it would be a good idea
  1605.       to switch the monitor off.
  1606.  
  1607.       When the user is ready to dial into the office PC from home, he will
  1608.       enter the command:
  1609.             TR OFFICE
  1610.       This will cause the modem to dial the office PC. The user must then
  1611.       listen to the modem and wait until he hears the 'phone ring once. As soon
  1612.       as he hears this, he must press any key (say the space bar) to terminate
  1613.       the call. TRHOST will start a timer going when the 'phone rings, and then
  1614.       wait 10 seconds, keeping track of the total time the 'phone has spent
  1615.       ringing. If, during the 10 seconds, the 'phone was ringing for more than
  1616.       0.2 seconds but less than .9 seconds, then TRHOST will pretend to "type"
  1617.       the keys:
  1618.             <Esc>trauto<enter>
  1619.       The <Esc> will ensure that anything currently on the command line is
  1620.       ignored, and the trauto will run the TRAUTO.BAT script. The batch file
  1621.       will check that the time of day is reasonable, and then call the user
  1622.       back. When the user's 'phone rings, the modem will send the message:
  1623.             RING
  1624.       to the home PC, and TR will trigger on this to respond to the modem with:
  1625.             ata
  1626.       which will answer the 'phone. TeleReplica will then synchronize "baud"
  1627.       rates, exchange passwords, and give the user control of the office PC.
  1628.  
  1629. A5.5  When the user is finished, he will exit TR using option 3, which will
  1630.       cause the modem to hang up and terminate the 'phone call. The office PC
  1631.       will then automatically reboot, ready for the user to call in again.
  1632.  
  1633.       [This is probably the most complicated set up of all, but it is the one
  1634.       the author has found most useful, and is in daily use by a number of
  1635.       staff at MUCG.]
  1636.  
  1637.  
  1638.       APPENDIX B - Sample File Transfer Session
  1639.  
  1640. B1    In this example, we will assume that a good link has been established as
  1641.       described in scenario A2. The user has logged into the LAN from home, and
  1642.       wishes to transfer all the C source files from the LAN directories:
  1643.             F:\USERDATA\FRED\TEST
  1644.             F:\USERDATA\FRED\UTILS
  1645.             F:\USERDATA\FRED\PROBLEM
  1646.       to the corresponding directories on his home PC:
  1647.             C:\PROGRAMS\TEST
  1648.             C:\PROGRAMS\UTILS
  1649.             C:\PROGRAMS\PROBLEM
  1650.       The current working directory on the LAN PC is F:\USERDATA\FRED. The
  1651.       current working directory on the home PC is C:\TR.
  1652.  
  1653.       First, the user needs to make C:\PROGRAMS the current working directory
  1654.       on his home PC. To do this, he must hold down Ctrl, Alt, LeftShift and
  1655.       RightShift all at the same time! This will bring up a screen similar to:
  1656.       ╔═══════════════════════════════════════════════════════════════════════╗
  1657.       ║ TeleReplica Copyright (c) 1992 Douglas Thomson                        ║
  1658.       ║                                                                       ║
  1659.       ║  Key         Effect                                                   ║
  1660.       ║  ===         ======                                                   ║
  1661.       ║  <F2>      - simulate carrier - not used with MODEM link              ║
  1662.       ║  <Ctrl-F2> - simulate NO carrier - not used with MODEM link           ║
  1663.       ║  <F6>      - send break, restart session                              ║
  1664.       ║  <F8>      - perform warm boot on host                                ║
  1665.       ║  <F9>      - shell to DOS                                             ║
  1666.       ║  <F10>     - exit TeleReplica                                         ║
  1667.       ║  <Alt-X>   - exit TeleReplica                                         ║
  1668.       ║  <Home>    - refresh display from HOST                                ║
  1669.       ║  <PgUp>    - upload file using DMP protocol                           ║
  1670.       ║  <PgDn>    - download file using DMP protocol                         ║
  1671.       ║                                                                       ║
  1672.       ║  <ESC>     - do nothing                                               ║
  1673.       ║                                                          Press key:   ║
  1674.       ╚═══════════════════════════════════════════════════════════════════════╝
  1675.       Then he should press <F9> to shell to DOS, and enter the command:
  1676.             CD \PROGRAMS
  1677.       to make C:\PROGRAMS the current working directory. Then he can enter the
  1678.       command:
  1679.             EXIT
  1680.       to return to TR.
  1681.  
  1682.       Next he needs to start the download. To do this he must again hold down
  1683.       Ctrl, Alt, LeftShift and RightShift, and then press <PgDn>. Another box
  1684.       will appear:
  1685.       ╔═══════════════════════════════════════════════════════════════════════╗
  1686.       ║ Name(s) of file(s) to be downloaded (use DOS wildcards):              ║
  1687.       ║ WARNING: Files with the same names on this PC will be overwritten!    ║
  1688.       ║                                                                       ║
  1689.       ╚═══════════════════════════════════════════════════════════════════════╝
  1690.       and he must enter the relative paths and wildcards:
  1691.       ╔═══════════════════════════════════════════════════════════════════════╗
  1692.       ║ Name(s) of file(s) to be downloaded (use DOS wildcards):              ║
  1693.       ║ WARNING: Files with the same names on this PC will be overwritten!    ║
  1694.       ║ TEST\*.C TEST\*.H UTILS\*.C UTILS\*.H PROBLEM\*.C PROBLEM\*.H         ║
  1695.       ╚═══════════════════════════════════════════════════════════════════════╝
  1696.  
  1697.       If there were some problem (for example, if TRPUT.EXE were not on the
  1698.       path of the LAN PC), then the following could be displayed:
  1699.       ╔═══════════════════════════════════════════════════════════════════════╗
  1700.       ║ TeleReplica Error:                                                    ║
  1701.       ║ no ready marker from host                                             ║
  1702.       ║ Type <ESC> to continue:                                               ║
  1703.       ╚═══════════════════════════════════════════════════════════════════════╝
  1704.  
  1705.       However, normally the download will then commence, leaving the following
  1706.       display:
  1707.             ╔═════════════════════════════════════════════╗
  1708.             ║ File Transfer in Progress...                ║
  1709.             ║                                             ║
  1710.             ║ File:       test\xyz.c                      ║
  1711.             ║                                             ║
  1712.             ║ Error:                                      ║
  1713.             ║                                             ║
  1714.             ║ Efficiency: 96.6%                           ║
  1715.             ║                                             ║
  1716.             ║ You may:                                    ║
  1717.             ║    1. Abort the file transfer               ║
  1718.             ║    2. Shell to DOS                          ║
  1719.             ║                                             ║
  1720.             ║ Selection:                                  ║
  1721.             ╚═════════════════════════════════════════════╝
  1722.       The number of bytes remaining to be transferred is displayed in the top
  1723.       right corner of the screen. The most recent error will be reported in the
  1724.       appropriate line of the box, and the efficiency of the transfer (relative
  1725.       to a perfect 10 bits per byte) may help to relieve the boredom while
  1726.       waiting for the transfer to complete! The box also indicates which file
  1727.       is currently being transferred.
  1728.  
  1729.       At this stage, the user can either wait for the transfer to finish, or
  1730.       else select option 2 from the menu and shell to DOS. In this case, he can
  1731.       use his home PC for other jobs while the transfer takes place in the
  1732.       background. TR will continue to display the number of bytes remaining in
  1733.       the top right corner until the transfer is completed, at which time the
  1734.       number in the top right corner will become the string "Completed" (or,
  1735.       possibly, "Doubtful" if one or more files could not be created on the
  1736.       home PC). However, the user must be careful not to do things like delete
  1737.       the file that is being downloaded!
  1738.  
  1739.       While shelled out to DOS in this way, the user may exit back into TR at
  1740.       any time. If the file transfer is still in progress, then the file
  1741.       transfer window will still be there; otherwise, the exit will leave TR
  1742.       displaying the normal replica of the host PC's display.
  1743.  
  1744.  
  1745.       APPENDIX C - Modem Cables
  1746.  
  1747. C1.   Minimum Standard Modem Cable
  1748.  
  1749.       Although a full 25-wire straight-through male-to-female RS232 cable is
  1750.       recommended for TeleReplica (since there is less room for error in the
  1751.       cable construction/selection), in fact the following signals are the only
  1752.       ones ever required or used:
  1753.  
  1754.       MALE (modem)                            FEMALE (PC)
  1755.       =============                           ========
  1756.       25D RS232 pin     signal       signal   25D   9D (as in AT)
  1757.       =============     ======       ======   ===   ==
  1758.                   2     TD  <------- TD         2    3
  1759.                   3     RD  -------> RD         3    2
  1760.                   4     RTS <------- RTS        4    7
  1761.                   5     CTS -------> CTS        5    8
  1762.                   7     GND <------> GND        7    5
  1763.                   8     CD  -------> CD         8    1
  1764.                  20     DTR <------- DTR       20    4
  1765.                  22     RI  -------> RI        22    9
  1766.  
  1767.       The following sections describe the kind of null modem cables that can be
  1768.       used with TeleReplica.
  1769.  
  1770. C2.   Simplest Possible 3-wire Null Modem Cable
  1771.  
  1772.       This is the most common kind of null modem cable, but TR and TRHOST must
  1773.       be set to ignore carrier detect, since the cable does not provide this
  1774.       information.
  1775.  
  1776.       MALE                                    FEMALE
  1777.       =============                           ========
  1778.       25D RS232 pin     signal       signal   25D   9D (as in AT)
  1779.       =============     ======       ======   ===   ==
  1780.                   7     GND <------> GND        7    5
  1781.                   3     RD  <------- TD         2    3
  1782.                   2     TD  -------> RD         3    2
  1783.  
  1784. C3.   Full TeleReplica Null Modem Cable
  1785.  
  1786.       If you can build or get hold of one of these, then TeleReplica can use
  1787.       carrier detect correctly. Note that CTS is not provided, and that
  1788.       TeleReplica must therefore be installed not to use it (there would be no
  1789.       point is using flow control with a direct cable in any case)!
  1790.  
  1791.       MALE                                    FEMALE
  1792.       =============                           ========
  1793.       25D RS232 pin     signal       signal   25D   9D (as in AT)
  1794.       =============     ======       ======   ===   ==
  1795.                   7     GND <------> GND        7    5
  1796.                   3     RD  <------- TD         2    3
  1797.                   2     TD  -------> RD         3    2
  1798.                  20     DTR -------> CD         8    1
  1799.                   8     CD  <------- DTR       20    4
  1800.  
  1801. C4.   Complete Null Modem Cable
  1802.  
  1803.       If you really want a complete null modem cable, which should work with
  1804.       ANY communications program, then I would suggest:
  1805.  
  1806.       MALE                                    FEMALE
  1807.       =============                           ========
  1808.       25D RS232 pin     signal       signal   25D   9D (as in AT)
  1809.       =============     ======       ======   ===   ==
  1810.                   7     GND <------> GND        7    5
  1811.                   3     RD  <------- TD         2    3
  1812.                   2     TD  -------> RD         3    2
  1813.                   5     CTS <------- RTS        4    7
  1814.                   4     RTS -------> CTS        5    8
  1815.                  20     DTR ----+--> CD         8    1
  1816.                                 |
  1817.                                 +--> DSR        6    6
  1818.                   8     CD  <--+---- DTR       20    4
  1819.                                |
  1820.                   6     DSR <--+
  1821.  
  1822.  
  1823.       APPENDIX D - DESQview Compatibility
  1824.  
  1825. D1.   TR is "DESQview-Aware" and runs nicely in a small DESQview window. TRHOST
  1826.       needs to put keys into the BIOS keyboard buffer, and this means that what
  1827.       is typed at the remote end cannot be distinguished by DESQview from what
  1828.       is typed at the real keyboard at the host end. The net effect is that
  1829.       there is no point in trying to run TRHOST in a DESQview window, and so
  1830.       TRHOST makes no attempt to be "DESQview-Aware". Also, DESQview is
  1831.       activated by "tapping" the ALT key, but TRHOST has no way to make this
  1832.       appear to happen, hence DESQview cannot be activated remotely. TRHOST and
  1833.       DESQview really don't mix!
  1834.  
  1835. D2.   For anyone wishing to set up DESQview for TR, these are the settings that
  1836.       I am currently using successfully:
  1837.       ╔1══Change═a═Program════════════════════════════════════════════════════╗
  1838.       ║                            Change a Program                           ║
  1839.       ║                                                                       ║
  1840.       ║ Program Name............: TR                                          ║
  1841.       ║                                                                       ║
  1842.       ║ Keys to Use on Open Menu: TR                  Memory Size (in K):  70 ║
  1843.       ║───────────────────────────────────────────────────────────────────────║
  1844.       ║ Program...: C:\TR\TR                                                  ║
  1845.       ║                                                                       ║
  1846.       ║ Parameters: REMOTE                                                    ║
  1847.       ║                                                                       ║
  1848.       ║ Directory.: \TR                                                       ║
  1849.       ║───────────────────────────────────────────────────────────────────────║
  1850.       ║ Options:                                                              ║
  1851.       ║               Writes text directly to screen.......: [N]              ║
  1852.       ║               Displays graphics information........: [N]              ║
  1853.       ║               Virtualize text/graphics (Y,N,T).....: [N]              ║
  1854.       ║               Uses serial ports (Y,N,1,2)..........: [1]              ║
  1855.       ║               Requires floppy diskette.............: [N]              ║
  1856.       ║                                                                       ║
  1857.       ║  Press F1 for advanced options           Press <─┘ when you are DONE  ║
  1858.       ╚═══════════════════════════════════════════════════════════════════════╝
  1859.       and advanced options:
  1860.       ╔1══Change═a═Program════════════════════════════════════════════════════╗
  1861.       ║                   Change a Program Advanced Options                   ║
  1862.       ║                                                                       ║
  1863.       ║ System Memory (in K):  0    Maximum Program Memory Size (in K)..:  70 ║
  1864.       ║                                                                       ║
  1865.       ║ Script Buffer Size:  100    Maximum Expanded Memory Size (in K):    0 ║
  1866.       ║                                                                       ║
  1867.       ║ Text Pages: 1  Graphics Pages: 0  Initial Mode:  Interrupts: 00 to 2F ║
  1868.       ║───────────────────────────────────────────────────────────────────────║
  1869.       ║ Window Position:                                                      ║
  1870.       ║    Maximum Height: 25     Starting Height: 25     Starting Row...:  1 ║
  1871.       ║    Maximum Width.: 80     Starting Width.: 80     Starting Column:  1 ║
  1872.       ║───────────────────────────────────────────────────────────────────────║
  1873.       ║                            Shared Program                             ║
  1874.       ║ Pathname..:                                                           ║
  1875.       ║ Data......:                                                           ║
  1876.       ║───────────────────────────────────────────────────────────────────────║
  1877.       ║ Close on exit (Y,N,blank)..: [Y]  Uses its own colors...........: [Y] ║
  1878.       ║ Allow Close Window command.: [N]  Runs in background (Y,N,blank): [Y] ║
  1879.       ║ Uses math coprocessor......: [N]  Keyboard conflict (0-4).......: [0] ║
  1880.       ║ Share CPU when foreground..: [Y]  Share EGA when foreground/....: [Y] ║
  1881.       ║ Can be swapped out (Y,N, ).: [N]  Protection level (0-3)........: [0] ║
  1882.       ║                                                                       ║
  1883.       ║  Press F1 for standard options           Press <─┘ when you are DONE  ║
  1884.       ╚═══════════════════════════════════════════════════════════════════════╝
  1885.  
  1886. D3.   When running under DESQview, the "shell to DOS" option during a file
  1887.       transfer is disabled, since DESQview does not permit interrupt handlers
  1888.       to call DOS and BIOS functions (necessary for reading and writing files).
  1889.       However, this is not a serious limitation under DESQview, since DESQview
  1890.       will allow you to run multiple simultaneous programs.
  1891.  
  1892. D4.   The normal "shell to DOS" option may be used under DESQview, but in this
  1893.       case more than 70K of memory will need to be allocated - with 4dos, it
  1894.       has been reported that at least 150K is required!
  1895.  
  1896.  
  1897.       APPENDIX E - Acknowledgements
  1898.  
  1899.       I would like to thank all the users of TeleReplica who have helped me to
  1900.       improve the package by suggesting new features and reporting
  1901.       difficulties. The following individuals in particular have had a
  1902.       significant impact on the current version:
  1903.             Mr Lindsay Smith, Monash University College, Gippsland, Australia
  1904.             Prof. Timo Salmi, University of Vaasa, Finland
  1905. ==============================================================================
  1906. ==============================================================================
  1907. ==============================================================================
  1908. ==============================================================================
  1909. ==============================================================================
  1910. ==============================================================================
  1911. ==============================================================================
  1912. ==============================================================================
  1913. ==============================================================================
  1914. ========================================================